home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Cream of the Crop 21
/
Cream of the Crop 21 (Terry Blount) (October 1996).iso
/
database
/
tickle15.zip
/
TKLFILE.DOC
< prev
next >
Wrap
Text File
|
1996-08-02
|
29KB
|
757 lines
Tickle File - Version 1.50
Written by Dan Shore - SysOp
The Shoreline BBS
August 2, 1996
1. TKL.PPE - Tickle File - The main program
────────────────────────────────────────
"Tickle File" is a program which maintains a personal database for
each user that accesses/uses "Tickle File". This personal database
can contain up to 24 filenames with an optional 15 character
description to "Tickle" their memory. Tickle a user's memory for
what you ask? Good question.
Let's say you were on the BBS today and wanted to download a file,
but you did not have enough time or bytes remaining to perform the
download. You could then add this filename with a short description
(to help remind you what the file was) to your database, and next
time you are on the BBS, you view your database, "Tickle" your memory,
and download the file(s) you wanted (If the BBS restrictions allow
you too during this session).
- What will the user see when Tickle File is invoked?
A. When invoking Tickle File from a PCB Menu
─────────────────────────────────────────
When a user invokes Tickle File from a PCB Menu, they will be presented
with the following screen:
┌────────────────────────────────────────────────────────┐
│ T I C K L E F I L E - Tickle your memory for that │
│ Written by: file you wanted to download │
│ Dan Shore during a previous session. │
├────────────────────────────────────────────────────────┤
│ A)dd..... Add new file(s) to your Tickle List │
│ D)elete.. Delete file(s) from your Tickle List │
│ F)lag.... Flag file(s) in Tickle List for downloading │
│ H)elp.... Display this file │
│ L)ist.... List all files in your Tickle List │
│ W)ipeOut. Wipeout (delete) your entire Tickle List │
└────────────────────────────────────────────────────────┘
Command: A)dd,D)elete,E)dit,F)lag,H)elp,L)ist,W)ipeOut [ENTER] = Quit ?
I believe the choices are fairly intuitive, but the menu (which is
called "HELP") can be modified by the sysop for better
display/explanation. (The reason it is called help, is due to the
menu only being shown when you first enter TKL.PPE. By choosing "H",
the user can have it redisplayed at anytime).
B. When "Tickle File" is invoked due to a violation (PCBText invokes
the PPE), the user will see the following (this example will use
PCBText number 159 for exceeding download daily byte limits -
FILENAME.ZIP = 522,856 bytes)
*──────────────────────────────────────────────────────────────────*
Sorry, Dan, not enough bytes remaining to process (FILENAME.ZIP)
Total Download bytes available : 307,200
Bytes used flagging files : 522,856
Bytes used downloading files : 0
Bytes left for downloading files: 307,200
Bulletin #19 explains security levels and access restrictions
*──────────────────────────────────────────────────────────────────*
You can add this file to your 'Filename Tickle List'
A "Tickle List" is a personal database that can hold up to
24 filenames, with an optional short 15 character description,
to help "TICKLE" your memory for files you wanted to download
on a previous day. (Use the "TF" command at the Main Menu to
access your database)
Just hit ENTER is you wish to bypass this feature....
Add this file to your Tickle List (Y,[N]) ?
- The first section (within the two lines) is "PCBT159" (which is
modifiable by the SysOp) and can show whatever information you want
to the user (Bulletins to read, messages, etc.) It is suggested
you keep the first line of text, as it is the same text from the
PCBText entry.
- The second section is called "INFO" (which again is modifiable by the
SysOp) and it helps explain what "Tickle File" is all about. This
file is displayed only when PCBText invokes the PPE. Make sure to
modify the file "INFO" to match the command you used in CMD.LST.
(See section #2 below on installation)
If the user responds to this prompt with a "Yes", they are prompted for
to add a short 15 character description to help them remember the
file they added to their database next time they were on.
2. Installation:
─────────────
A. Make a directory and unzip the entire contents of the archive into
this directory. (I would recommend a directory structure where all
your PPE's have their own directory located under a PPE directory.
This of course is optional and entirely up to you)
B. Add an entry to your CMD.LST file. Here is an example:
Note: You can make your COMMAND anything you wish, TF just
makes sense for "Tickle File"
Charges Per PPE/MNU File Specification -or-
Command Sec Minute Use Keystroke Substitution
══════════════ ═══ ═════════════════ ═════════════════════════════════
TF 5 0 0 C:\PCB\PPE\TKL\TKL.PPE MENU
This entry is for a user to use Tickle File from one of your menus.
NOTE: Make sure to adjust the security level to match your system
NOTE: The "MENU" parameter instructs the PPE that you have entered the
program via a command and not a violation (PCBText invokes the
PPE when a violation occurs).
C. Make changes to your PCBText file
You can run the batch file included in the archive (CHNGPCBT.BAT) to
change your PCBText file for you (automated way). Make sure you run the
batch file from the same directory where your PCBTEXT file is located,
*OR* change the batch file to match the path to your PCBTEXT file (see
example below)
MKPCBTXT PCBTEXT /I:138 "!C:\PCB\PPE\TKL\TKL.PPE @OPTEXT@ 138"
MKPCBTXT C:\PCB\GEN\PCBTEXT /I:138 "!C:\PCB\PPE\TKL\TKL.PPE @OPTEXT@ 138"
You can also change your PCBText by hand. The following will give you a
guideline for the changes which need to be done.
NOTE: You need to pass TWO parameters
(REQUIRED for proper operation):
1. @OPTEXT@ for the filename
2. The PCBText number
NOTE: Make sure to change the path of the PPE to match your system.
Change PCBTEXT entry 138 to:
!C:\PCB\PPE\TKL\TKL.PPE @OPTEXT@ 138
Change PCBTEXT entry 159 to:
!C:\PCB\PPE\TKL\TKL.PPE @OPTEXT@ 159
Change PCBTEXT entry 555 to:
!C:\PCB\PPE\TKL\TKL.PPE @OPTEXT@ 555
Change PCBTEXT entry 668 to:
!C:\PCB\PPE\TKL\TKL.PPE @OPTEXT@ 668
Change PCBTEXT entry 669 to:
!C:\PCB\PPE\TKL\TKL.PPE @OPTEXT@ 669
Change PCBTEXT entry 670 to:
!C:\PCB\PPE\TKL\TKL.PPE @OPTEXT@ 670
Change PCBTEXT entry 674 to:
!C:\PCB\PPE\TKL\TKL.PPE @OPTEXT@ 674
Change PCBTEXT entry 675 to:
!C:\PCB\PPE\TKL\TKL.PPE @OPTEXT@ 675
*****************************************************************
NOTE: Make sure to REVIEW each PCBT???? file modifying any text
in these files to match your system setup.
*****************************************************************
D. TKL.PPE Configuration File
There is a configuration file to use with TKL.PPE and it is called
TKLx.CFG (x = conference number for which the configuration file will
apply to). The three lines of the configuration file are:
1. (TRUE or FALSE) Check for file existence before adding the file
to the database. If the file is being added by
PCBText invoking the PPE, then a file check is
not needed, since PCB already checked the files
existence. If the user is adding a file
manually, then this parameter will determine
if the files existence is checked.
TRUE = Check for files existence
FALSE = Do not check for files existence
2. (TRUE or FALSE